home *** CD-ROM | disk | FTP | other *** search
/ Megahits 5 / Megahits 5 (1994)(GTI - Rhein-Main-Soft)(DE)(Disc 2 of 2)[!].iso / archive / show / logg13.lha / 1.3 / QUICK_HELP.Doc < prev    next >
Text File  |  1994-02-26  |  11KB  |  203 lines
  1.  
  2.                                     LoGG 1.2
  3.  
  4.                                    QUICK HELP
  5.  
  6.                      Copyright (c) 1991-94 A. G. Kartsatos
  7.  
  8.  
  9.      1)  To run the program with most of the basic functions working, you 
  10. will need at least these files in your current "c" directory:
  11.  
  12.                    CD, ENDCLI, EXECUTE, LoGG.file, RUN, STACK
  13.  
  14.      Some of these files might be built-in for AmigaDos 2.0 for the 3000.
  15.      LoGG looks for the file "LoGG.file" in your "c" directory as well as
  16. as your current directory.  The program will abort if it does not locate this
  17. file.  This is the file that contains the names of your drives, the 4 colors
  18. and the 48 user-definable gadgets.
  19.  
  20.      2)  For a fully operational LoGG you will need the following files in
  21. your current "c" directory:
  22.  
  23.   ARC, CD, EDIT, ENDCLI, EXECUTE, LHARC, LoGG.file, PAK, RUN, STACK, WARP, ZOO
  24.  
  25.      Some of these files might already be built-in with the Amigados 2.0 of
  26. the Amiga 3000.
  27.      You must name these files exactly as above.  For example, EDIT is 
  28. your favourite editor program.  The files CD, ENDCLI, RUN and STACK are your
  29. usual Workbench files.
  30.  
  31.      3)  To make one of the two windows on your front panel the SOURCE
  32. window, just click into its vertical gadget or anywhere into it.  Then the 
  33. other window will automatically become the DESTINATION window.
  34.  
  35.      4)  Click fast twice on the name of a directory in order to attach to
  36. it.  If a DRIVE is not listed in your list of 14 drives, and you want to
  37. see a pathname in it, just enter the desired pathname into the "D" or "S" 
  38. gadget and press <RETURN>.
  39.  
  40.      5)  Configure LoGG so that it carries your own 4 colors and your own 14
  41. drives.  Attach to a place where you can find your palette.  Run the palette
  42. by selecting it first and then clicking into LoGG's RUN gadget.  Change 
  43. any of the 4 colors on the palette (you get 3 HEX numbers for each color),
  44. and then place those 12 numbers in the third line of your LoGG.file.
  45.      To place your own drives in LoGG, just enter 14 drive names into the
  46. first two lines of your LoGG.file.  You may repeat drive names of course.
  47.      After you have made any change to your LoGG.file while you are running
  48. LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
  49. itself to the change.
  50.  
  51.      6)  Study the file LoGG.file so that you can create up to 48 gadgets
  52. with your own titles and your own commands.  
  53.      The titles of the gadgets should be at most 8 characters long.
  54.      The corresponding title entries in the file LoGG.file should be exactly
  55. 10 characters long, like "DPAINT   *", "CONTOURA *", etc.  You should not
  56. include the quotes in your LoGG.file.
  57.      The MACROS (Entries 1 - 24 in your LoGG.file) can accommodate up to 
  58. 7 different command lines each.  Only the first of these commands can contain
  59. the token "CD" in it and a symbol for the CLI as described below.
  60.      Only the first token of the first command line of a MACRO can be "CD".
  61.      The PARMS (Entries 25 - 48 in your LoGG.file) can only carry one 
  62. command line.  This command line can have up to 5 tokens and at most 2 para-
  63. meters.  For example,
  64.  
  65.      "FIXOBJ %s %s (R) (SMALL)", "HELLO %s HERMES %s JULIE (R) (TINY)", 
  66.                              "EDITOR %s (FULL)"
  67.  
  68. are acceptable PARMS command lines.  If there are two parameters (%s) in a
  69. PARMS command, the first one is a highlighted file and the second is a
  70. string that you enter in the file requestor.  If there is only one parameter
  71. in your command line, there are two possibilities: 1) If there is a file
  72. selected (highlighted), LoGG will pick the name of that file for this para-
  73. meter.  2) If there is no selected file, LoGG will bring the requester out
  74. for you to enter a string for this parameter.
  75.      The symbols (TINY), (SMALL) and (FULL) are the sizes of the CLI windows
  76. that you can open with your command.  They are always at the very end of
  77. your command and at least one space away from the previous command token.
  78.      Naturally, you can only use one such symbol per command.
  79.      The symbol "(R)" here means that you want to have the file listing
  80. refreshed after the execution of this command.  The symbol "(R)" must be
  81. placed at the end of your command before any CLI symbol.  "(R)" must again
  82. be at least one space away from from adjacent command token.
  83.      After you have made any change to your LoGG.file while you are running
  84. LoGG, just choose the CONFIGURE item of the first menu to get LoGG to adjust
  85. itself to the change.
  86.  
  87.      7)  Sometimes your LoGG.file gets funny with some, possibly invisible,
  88. characters in it.  To correct it, just run the file FIX_FILE.  This file
  89. will attempt to correct your LoGG.file and put the corrected contents in
  90. a file called LoGG.file1.  Just rename LoGG.file1 as LoGG.file and continue
  91. as usual.
  92.  
  93.      8)  IMPORTANT!  Do not forget that you can stop the SEARCHING OF FILES
  94. AND STRINGS, CATALOGING, COPYING AND MOVING OF FILES, etc., by just
  95. clicking into the STOP BUTTON on your front panel.
  96.  
  97.      9)  To copy files from one of the display windows into another path
  98. not currently on display in the opposite window, you can just enter that
  99. path in the DESTINATION BUFFER "D" and click into the COPY gadget.  When
  100. copying is finished, LoGG will list that destination path.  The same remark
  101. applies to the MOVE operation.
  102.  
  103.      10)  Pressing QUIT while FORMATTING/DISKCOPYING might corrupt the desti-
  104. nation disk.  Do not use QUIT (on the FORMAT/DISKCOPY requester) unless
  105. it is absolutely necessary.
  106.  
  107.      11)  READ: This is a fully operational file reader.  It will list
  108.           the selected file and will scroll through it very fast.  It
  109.           has 8 menu items.  We will only elaborate on the items that
  110.           need some explanation.  Just remember that YOU CAN SCROLL
  111.           THE TEXT UP AND DOWN BY USING THE RESPECTIVE ARROW KEYS or by
  112.           CLICKING into the upper or lower half of the reader screen.
  113.     
  114.                (1) GO TO LINE:  You can choose this menu item, or just
  115.                    press RIGHT_AMIGA-G instead.  As soon as you do that,
  116.                    the GOTO-gadget clears up.  Just go ahead and type
  117.                    in the line number you want to see.  Then press
  118.                    <RETURN>.  The program will then try to exhibit that line
  119.                    as the top line of the page.  Another way of doing this:
  120.                    Just click into the GOTO-gadget, clear it up by using
  121.                    the BACKSPACE key (or pressing RIGHT_AMIGA-X), enter
  122.                    the line number that you wish to exhibit, and then press
  123.                    <RETURN>.
  124.                    The program will do nothing if the line number that you 
  125.                    have entered does not exist.
  126.                     
  127.  
  128.                (2) FIND STRING:  You can choose this menu item, or just
  129.                    press RIGHT_AMIGA-F instead.  As soon as you do that,
  130.                    the FILE-gadget clears up.  Just go ahead and type
  131.                    in the string that you want to see.  Then press
  132.                    <RETURN>.  The program will then try to exhibit that
  133.                    string at the top line of the page.  Another way of doing 
  134.                    this: Just click into the FILE-gadget, clear it up by 
  135.                    using the BACKSPACE key (or pressing RIGHT_AMIGA-X),
  136.                    enter the string that you wish to exhibit, and then
  137.                    press <RETURN>.
  138.                    The program will do nothing if the string that you have
  139.                    entered does not exist from the current line on.
  140.  
  141.                (3) SEARCH AGAIN:  Well, now that you have found the string,
  142.                    just choose this menu item or press RIGHT_AMIGA-S to
  143.                    try to find the string again.  The program will try to
  144.                    locate the string and exhibit it at the top line of 
  145.                    the page.  Again, the program tries to locate the given
  146.                    string starting from the secong line of your page down
  147.                    to the end of the file.
  148.                 
  149.      12)  You should change to HIRES (clicking into the RESOL gadget) if
  150. you have more than 800 files in the same directory listing.  Otherwise you
  151. will get a partial listing of these files.  If you are using the MEDIUM re-
  152. solution mode and LoGG finds out that there are more than 800 files in your
  153. directory, LoGG will inform you that you should change into the HIRES mode.
  154.  
  155.      13)  The STOP button does stop a file from being printed to your
  156. printer, but it takes some time before the Amiga responds to the signal
  157. to stop.  So, be a little patient.
  158.  
  159.      14)  If you get a little confused about the exact name of a file which
  160. is not completely listed, just select the file and click into the FILEINFO
  161. gadget.  The FILEINFO gadget contains the entire name of the file and
  162. information on the file's Protection Bits, Comment and Date of creation.
  163.  
  164.      15)  Whenever a CLI appears in the execution of a command or in an 
  165. archiving process, you should close it by pressing EndCLI.  It is important
  166. that you have this command included in your "c" directory.
  167.  
  168.      16)  If you change your LoGG icon (this is the program icon, not the
  169. disk icon), please remember to enter the data in the TOOL TYPES gadget in 
  170. the new icon as they appear in the original one.
  171.      The icon that LoGG comes with opens a 1-pixel window on your WorkBench
  172. just in case LoGG needs to put some output somewhere.  If you do not take
  173. care of this, LoGG may crash your machine when it tries to write an error
  174. statement into a nonexistent window.
  175.  
  176.      17)  When a directory has a lot of subdirectories, you may get a list-
  177. ing in one of the panel windows consisting only of directories.  Thus, you
  178. do not see the files which follow below.  If any of these files have been
  179. highlighted and you click into DELETE, you might delete the files without
  180. even ever seeing them.  So, please exercise caution with gadgets like DELETE
  181. and MOVE.  It is good practice to click into the CLEAR gadget from time
  182. to time in order to avoid cases like this.
  183.  
  184.      18)  If the disk you have just inserted (or a path on it) is listed
  185. in one of your front panel windows, you should refresh that window's listing
  186. by using the SOURCE or DESTINATION gadgets, or by clicking into one of your
  187. drive gadgets.  To see why you need to do this, suppose that you have listed
  188. "DF1:" in your DESTINATION gadget.  Now, suppose that you insert a new disk
  189. in "DF1:" (not the one you have just removed).  Then if you do not refresh
  190. the DESTINATION window, LoGG will think that the current listing there is the
  191. listing of the disk that you have just inserted.  Although no damage can
  192. result from this, you can get a confusing listing of files and directories 
  193. in that window if, e.g., you try to copy files there.  LoGG will notify you
  194. to refresh your window(s) whenever disks have been inserted or modified (via
  195. FORMAT, DISKCOPY, etc.).
  196.  
  197.      19)  Please avoid using names of directories and files that contain
  198. empty spaces in them.  You can always replace, for exampe, "HELLO JOHN" by 
  199. "HELLO_JOHN".
  200.      Certain archiving programs (among others) do not work right with such
  201. names.  Although LoGG will do its best to work with such names (in the first
  202. 48 built-in gadgets), there is still some overhead in trying to do so.
  203.